package com.fau.wmbj.server.service.base;

import com.fau.wmbj.server.utils.Filter;
import com.fau.wmbj.server.utils.Order;
import com.fau.wmbj.server.utils.Page;
import com.fau.wmbj.server.utils.Pageable;

import java.io.Serializable;
import java.util.List;

/**
 * Service - 基类
 *
 * @author jiawei
 * @version 1.0
 * @datetime 2023-03-09 9:18
 */
public interface BaseService<T, ID extends Serializable> {

    /**
     * 查找实体对象
     *
     * @param id ID
     * @return 实体对象，若不存在则返回null
     */
    T find(ID id);

    /**
     * 查找所有实体对象集合
     *
     * @return 所有实体对象集合
     */
    List<T> findAll();

    /**
     * 查找实体对象集合
     *
     * @param ids ID
     * @return 实体对象集合
     */
    @SuppressWarnings("unchecked")
    List<T> findList(ID... ids);

    /**
     * 查找实体对象集合
     *
     * @param ids ID
     * @return 实体对象集合
     */
    @SuppressWarnings("unchecked")
    List<T> findList(List<ID> ids);

    /**
     * 查找实体对象集合
     *
     * @param count   数量
     * @param filters 筛选
     * @param orders  排序
     * @return 实体对象集合
     */
    List<T> findList(Integer count, List<Filter> filters, List<Order> orders);

    /**
     * 查找实体对象集合
     *
     * @param filters 筛选
     * @return 实体对象集合
     */
    List<T> findList(Filter... filters);

    /**
     * 查找实体对象集合
     *
     * @param first   起始记录
     * @param count   数量
     * @param filters 筛选
     * @param orders  排序
     * @return 实体对象集合
     */
    List<T> findList(Integer first, Integer count, List<Filter> filters, List<Order> orders);

    /**
     * 查找实体对象分页
     *
     * @param pageable 分页信息
     * @return 实体对象分页
     */
    Page<T> findPage(Pageable pageable);

    /**
     * 查询实体对象总数
     *
     * @return 实体对象总数
     */
    long count();

    /**
     * 查询实体对象数量
     *
     * @param filters 筛选
     * @return 实体对象数量
     */
    long count(Filter... filters);

    /**
     * 查询实体对象数量
     *
     * @param filterList 筛选
     * @return 实体对象数量
     */
    long count(List<Filter> filterList);

    /**
     * 判断实体对象是否存在
     *
     * @param id ID
     * @return 实体对象是否存在
     */
    boolean exists(ID id);

    /**
     * 判断实体对象是否存在
     *
     * @param filters 筛选
     * @return 实体对象是否存在
     */
    boolean exists(Filter... filters);

    /**
     * 保存实体对象
     *
     * @param entity 实体对象
     * @return 实体对象
     */
    T save(T entity);

    /**
     * 更新实体对象
     *
     * @param entity 实体对象
     * @return 实体对象
     */
    T update(T entity);

    /**
     * 查询实体
     *
     * @param filters 筛选
     * @return 实体对象是否存在
     */
    T findEntity(Filter... filters);

    /**
     * 查询实体
     *
     * @param filters 筛选
     * @return 实体对象是否存在
     */
    T findEntity(List<Filter> filters);

    /**
     * 更新实体对象
     *
     * @param entity           实体对象
     * @param ignoreProperties 忽略属性
     * @return 实体对象
     */
    T update(T entity, String... ignoreProperties) throws Exception;

    /**
     * 逻辑删除
     *
     * @param id ID
     */
    void deleteLogic(ID id) throws Exception;

    /**
     * 删除实体对象
     *
     * @param id ID
     */
    void delete(ID id) throws Exception;

    /**
     * 删除实体对象
     *
     * @param ids ID
     */
    @SuppressWarnings("unchecked")
    void delete(ID... ids) throws Exception;

    /**
     * 删除实体对象
     *
     * @param ids ID
     */
    void delete(List<ID> ids) throws Exception;

    /**
     * 删除实体对象
     *
     * @param entity 实体对象
     */
    void delete(T entity) throws Exception;

    /**
     * 获取实体对象id
     */
    ID getIdentifier(T entity);

    /**
     * 判断是否唯一
     *
     * @param id             ID
     * @param attributeName  属性名称
     * @param attributeValue 属性值
     * @return 是否唯一
     */
    boolean unique(ID id, String attributeName, Object attributeValue);

    /**
     * 判断是否唯一
     *
     * @param id             ID
     * @param attributeName  属性名称
     * @param attributeValue 属性值
     * @param ignoreCase     忽略大小写
     * @return 是否唯一
     */
    boolean unique(ID id, String attributeName, String attributeValue, boolean ignoreCase);

}
